home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #14 / Monster Media No. 14 (April 1996) (Monster Media, Inc.).ISO / bbs_door / vfy_39.zip / 4-LORA.ZIP / LORASEC.DOC < prev    next >
Text File  |  1995-12-26  |  6KB  |  168 lines
  1.         **************************************************************
  2.         *                                                            *
  3.         *                      LORASEC.EXE v1.0                      *
  4.         *                                                            *
  5.         *       LoraBBS User Security Level Adjustment Program       *
  6.         *                                                            *
  7.         *                     Copyright (c) 1995                     *
  8.         *                Sagerquist Micro Engineering                *
  9.         *                                                            *
  10.         *                   1414 W. Kerrick Street                   *
  11.         *                    Lancaster, Ca. 93534                    *
  12.         *                  Data BBS  (805) 723-6908                  *
  13.         *                Internet E-Mail  zs@qnet.com                *
  14.         *            WWW Page http://www.av.qnet.com/~zs/            *
  15.         *                                                            *
  16.         **************************************************************
  17.  
  18. DESCRIPTION
  19. -----------
  20.     LORASEC.EXE adjusts a LoraBBS caller's security level when
  21.     returning from a DOOR.  This action is useful when invoking
  22.     BBS Doors such as a Call Back Verification, a Questionnaire or
  23.     Opinion Poll, etc., where the caller is to be rewarded with a
  24.     security level adjustment upon successful completion.  
  25.  
  26. SYNTAX
  27. ------
  28.     LORASEC [/L:(Line (task) Number in Hexadecimal)]
  29.         [/D:(Node Directory (location of LORAINFO.Txx - optional)]
  30.         [/S:(New Security Level from the chart)]
  31.  
  32.     Note:    The line (task) numbers are two characters, a hexadecimal 
  33.         representation like the following numbers:
  34.  
  35.         01    02    0A    D5    6A
  36.  
  37.         There are only 12 security level values.  These 12 values
  38.         can be represented in two different ways each: Alpha and
  39.         Numeric.  Choose either Alpha or Numeric from the chart:
  40.  
  41.             TWIT       16
  42.             DISGRACE   32
  43.             LIMITED    48
  44.             NORMAL     64
  45.             WORTHY     80
  46.             PRIVIL     96
  47.             FAVORED    112
  48.             EXTRA      128
  49.             CLERK      144
  50.             ASSTSYSOP  160
  51.                *SYSOP      176    <--- Cannot be reached by an
  52.                *HIDDEN     192    <--- external program.
  53.  
  54.         /D:... switch is optional.  It will override the default 
  55.               value: C:\LORABBS.  If your LoraBBS system is set up on a 
  56.               different drive or directory, use the command line switch 
  57.               to override the default values.
  58.  
  59. EXAMPLES
  60. --------
  61.     LORASEC /L:01 /S:100
  62.     LORASEC /L:1A /D:F:\LORABBS /S:NORMAL
  63.     LORASEC /L:BD /D:D:\LORABBS /S:128
  64.     LORASEC ?
  65.  
  66. SAMPLE TRAP DOOR BATCH FILE
  67. ---------------------------
  68.     @ECHO OFF
  69.     C:
  70.     CD C:\LORABBS\VERIFY!
  71.     VERIFY! /B:LORABBS /D:C:\LORABBS
  72.     rem  ERRORLEVEL 0 and 1 means caller is verified.  
  73.     rem  ERRORLEVEL 0 == local call, successful verification
  74.     rem  ERRORLEVEL 1 == long distance, successful verification
  75.     IF ERRORLEVEL 0 IF NOT ERRORLEVEL 2 goto ADJUST
  76.     goto END
  77.     :ADJUST
  78.     rem  Adjust caller's security level to NORMAL
  79.     C:\LORABBS\LORASEC /L:01 /S:NORMAL
  80.     :END
  81.     CD C:\LORABBS
  82.  
  83. TECHNICAL
  84. ---------
  85.     LORASEC.EXE was designed to compliment VERIFY!.EXE, a BBS Call Back
  86.     Verify program, and both were originally intended for use in a DOOR.
  87.     When a LoraBBS DOOR launches, LoraBBS creates LORAINFO.Txx.  It 
  88.     contains the caller's information.  If values are changed in this 
  89.     file, the data in LoraBBS's databases are automatically updated.  
  90.     LORASEC.EXE will change the data in LORAINFO.Txx to accomplish its 
  91.     goals.
  92.  
  93.     SHARE.EXE:
  94.  
  95.     All files are opened in SHARE mode, allowing other applications
  96.     to access the files.  The current user's record in USERS.BBS is 
  97.     "locked" prior to changing any values which ensures other 
  98.     applications cannot crash the system by trying to alter the same 
  99.     area of the file.  SHARE.EXE must be loaded for LORASEC to operate 
  100.     on a multitasking system (multiple nodes).  Without SHARE.EXE on 
  101.     a multinode system, it is highly likely that LORASEC will fail when 
  102.     accessing USERS.BBS.  LORASEC will operate without SHARE.EXE on a 
  103.     single node system.  
  104.  
  105.     On exit of LORASEC, ERRORLEVELs are returned.  Your batch file can
  106.     check the ERRORLEVEL and determine what has happened.  The following
  107.     is a list of LORASEC's ERRORLEVELs and their meaning:
  108.  
  109.     ERRORLEVEL   0        Normal exit, adjustment successful.
  110.     ERRORLEVEL  10        Command line error.
  111.     ERRORLEVEL  40        Memory allocation error.
  112.     ERRORLEVEL  50        File open error.
  113.     ERRORLEVEL  60        File read error.
  114.     ERRORLEVEL  70        File write error.
  115.  
  116.     The actual reason for the error is written to the screen.
  117.  
  118.     Review your DOS manual for more information on ERRORLEVELs.
  119.  
  120. PROGRAMMING SERVICES
  121. ====================
  122.     LORASEC.EXE is a custom program, and performs exactly as requested.
  123.  
  124.     Programming services are provided by Sagerquist Micro Engineering
  125.     by request.  The points of contact are:
  126.  
  127.     The SME Support BBS ---------->    (805) 723-6908 28800 Baud
  128.     Internet E-Mail -------------->    zs@qnet.com
  129.     Internet World Wide Web Page-->    http://www.av.qnet.com/~zs/
  130.  
  131.     Post Office "Snail Mail":
  132.  
  133.     Sagerquist Micro Engineering
  134.     1414 W. Kerrick St.
  135.     Lancaster, CA 93534
  136.  
  137.     If you have an idea for a program of any kind, please call!
  138.  
  139. DISCLAIMER
  140. ----------
  141.     This program is distributed as is.  No warranty, either expressed or
  142.     implied is offered and the programmer is not responsible for any
  143.     damages or expenses that may occur through the use of this program.
  144.     The user shall determine its suitability.  Extensive testing has been
  145.     performed and every effort has been made to ensure satisfactory 
  146.     performance prior to release.  Please communicate any difficulties 
  147.     with the programmer through one of the contacts listed above.  Any 
  148.     problems received will be treated as a top priority.
  149.  
  150. CREDITS
  151. -------
  152.     LoraBBS is copyrighted software by Marco Maccaferri.
  153.     BBS: 39-51-6331730 (2:332/402)
  154.          39-51-6331746 (2:332/422)
  155.     Internet: macca@arci01.bo.cnr.it
  156.           100421.1633@compuserve.com
  157.       CompuServe: 100421,1633
  158.  
  159. HISTORY
  160. -------
  161.     Version 1.0 - 12/05/95
  162.     ----------------------
  163.         First release.  Remaining time adjustments removed for now.
  164.  
  165.     Version 0.1 - 12/05/95
  166.     ----------------------
  167.         First beta release, waiting for user input.
  168.